home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 June / Macworld (1998-06).dmg / Shareware World / Education / Master Spell 3.1.3 / Master Spell Info < prev    next >
Text File  |  1998-03-27  |  15KB  |  284 lines

  1.                                   
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                                        © 1998 Jay Lichtenauer
  12.                                                        jaylich@interaccess.com
  13.                                                            jaylicht@kagi.com
  14.  
  15.  
  16. Maybe you were thinking differently when you bought your Mac. 
  17. More likely, you were just thinking. 
  18.  
  19. I hope Master Spell reinforces the habit. 
  20.  
  21.  
  22. Contents 
  23.  
  24.  1.  The Aim of Master Spell
  25.  2.  Features
  26.  3.  Changing the voice
  27.  4.  Custom Spelling Lists
  28.  5.  Recommended Lesson Plan
  29.  6.  Minimum Requirements
  30.  7.  Limitations and Caveats
  31.  8.  Master Spell is Shareware
  32.  9.  Miscellaneous
  33. 10. Version History
  34.  
  35.  
  36.  
  37. 1. The Aim of Master Spell
  38.  
  39. • To help Mac users of all ages spell better. (I wish I could help Windows users too, but first they
  40.    have to help themselves choose a better computing platform.)
  41.  
  42. • To be Mac’ish: simple enough for an eight year-old to operate, sophisticated
  43.    and powerful enough for an adult.
  44.  
  45. • To help high school-aged, college-aged and older adults spell better by collecting
  46.    many hundreds of commonly misspelled words for tests.
  47.  
  48. • To allow the spelling words for younger people to be determined by their teachers
  49.    and then easily typed as a text file to be used as a test.
  50.  
  51.  
  52.  
  53. 2. Features
  54.  
  55. Master Spell administers spelling drills using the Mac’s speech capabilities. It’s a FAT binary application which means it runs at optimal speed regardless of whether you have a PowerPC Macintosh or a 68K Macintosh. The front panel will fit on even the smallest color monitor (512 x 384). 
  56.  
  57.  
  58. Custom Spelling Word Lists
  59.  
  60. Master Spell uses plain text files for its spelling tests. These can be easily created, edited and tested for correct pronunciation in SimpleText. (See 4. Custom Spelling Lists below).
  61.  
  62.  
  63. Individual Scoring and History
  64.  
  65. Each user gets a pupil file which contains the pupil's score history, the pupil's trouble words and the pupil's last settings.
  66.  
  67.  
  68. Multiple Review Options with Variable Emphasis on Trouble Words
  69.  
  70. For each pupil, Master Spell keeps a rotating list of the last 50 misspelled words. These trouble words can be integrated into tests randomly with the "Integrate Trouble Words" option in the Review menu. It is also possible to test on the trouble words alone with the "Test on Trouble Words" item in the Review menu. And one can study their trouble words, save their trouble words as a test file or clear the trouble words list from the "Study Trouble Words…" item in the Review menu.
  71.  
  72. At the end of a test, Master Spell prompts you to option to retry any misspelled words for half credit.
  73.  
  74.  
  75. Comprehensive Score Analyzation
  76.  
  77. At the end of a test, you are presented with an itemized "Test Summary" containing words you spelled correctly, incorrectly and correctly on the second try. The "Test History…" item in the Results menu displays a window that contains your test history. The "Graph Scores…" item in the Results menu presents you with a graph of your scores, the total number of words you've been tested on and your per word average.
  78.  
  79.  
  80. Printing of Graph and Score History
  81.  
  82. Master Spell can print your graph, number of words tested, per word average and complete history using the "Print…" item in the File menu.
  83.  
  84.  
  85. Anti-redundancy Routines
  86.  
  87. Master Spell picks words randomly and, in so doing, tries to avoid giving the same word more than once in a test. On a PowerPC Macintosh, redundancy will likely never occur within a test unless the test list contains less words than the number of words you choose to have administered. On a 68K Macintosh, Master Spell makes a valiant attempt to avoid redundancy.
  88.  
  89.  
  90. Alternate Spellings
  91.  
  92. Master Spell accepts alternate spellings for words. If the word is spelled correctly, Master Spell will present you with the alternate spelling. If the word is spelled incorrectly, Master Spell will present both spellings. (See 4. Custom Spelling Lists below for syntax on adding alternate spellings)
  93.  
  94.  
  95. Adjustable Pronunciation and Definitive Clues
  96.  
  97. Master Spell lists allow the ability to give definitions, examples and clarification for words that are pronounced the same way but have different spellings and different meanings.
  98.  
  99.  
  100. Audible and Visible Correction
  101.  
  102. Misspelled words are presented letter by letter visually and audibly.
  103.  
  104.  
  105.  
  106. 3. Changing the voice
  107.  
  108. Use the "Speech" control panel to change the voice and rate of speech. I recommend "Fred" which is installed with Macintalk 3. I have done all I can to overcome any problems with understanding what Fred is saying by adding clarifications for all of the Master Spell words. Just think of Fred as someone with a strange accent which you have to get used to. I understand everything Fred says now because I’ve been listening to him and the original Macintalk since the early Talking Moose days.
  109.  
  110.  
  111.  
  112. 4. Custom Spelling Lists
  113.  
  114. A spelling word test file can be made with SimpleText or any other text editor that can save its contents as a plain text file.  SimpleText is probably the best because you can test out the pronunciation of a word before using it in the test.
  115.  
  116. The syntax of a spelling words text file is as follows:
  117.  
  118. grey/gray; gray, as in gray is such a gloomy color.
  119.  
  120. The first word, “grey”, is the actual spelling word
  121.  
  122. A second word followed by a slash, “gray”, is the alternate spelling word.
  123.  
  124. A semicolon following a spelling word indicates to Master Spell that it should say whatever follows the semicolon on that line.  The text following the semicolon may be phonetically spelled.  In this case, “gray, as in gray is such a gloomy color.” will be spoken. If you add a semicolon and do not add any text after it, Master Spell will say, "Spell..." and nothing else at which point you can play a not so fun guessing game or you can test your psychic friend.
  125.  
  126. To make a pause in the text the Master Spell will say, use a comma since the semicolon indicates the seperation between the spelling word and the text Master Spell will say.
  127. If you don’t provide spoken text after the semicolon, Master Spell will say the spelling word or it will say the alternate spelling if it is present.
  128.  
  129. Other examples of valid spelling word entries:
  130.  
  131. three
  132. traveler/traveller
  133. repetitious; repehtih shus, as in, I try not to be repehtih shus
  134.  
  135. See the spelling word test file, “Syntax Example”.
  136.  
  137.  
  138.  
  139. 5. Recommended Lesson Plan
  140.  
  141. The spelling words included with Master Spell are intended for high school students, college students and beyond. So that you don’t overwhelm yourself and so that you can start to see progress earlier, I have broken the 1,345 words down into four files.
  142.  
  143.                Basic Words               (included)
  144.                Intermediate Words   (available after registering)
  145.                Tricky Words            (available after registering)
  146.                Difficult Words         (available after registering)
  147.  
  148. I suggest starting with the Basic Words since it is immediately available with this package. This test file contains over 300 words for you to concentrate on first. By concentrating on small sets of words you will be able to see your progress sooner.
  149.  
  150. Unless you are better than me, you will get words wrong. You should take advantage of the Trouble Words tracking by occassionally selecting the “Study Trouble Words…” item in the Review menu. These are, at most, the last 50 words you misspelled. After studying these words, go for a test on just your trouble words by selecting the “Test on Trouble Words” option in the Review menu.  The next test you start will be only on these words.  See how you do.
  151.  
  152. Take a look at your graph window to see if you are making progress. I consider spelling mastery to occur when your test percentages consistently fall in the 95% - 100% range. You receive the most enthusiastic cheers when you achieve test result averages in this range.  My average per word average is 90% as of this writing.
  153.  
  154. By the time you have mastered the Basic Words, you should have received your password for the other tests (if you registered) and you can start concentrating on the next test level.
  155.  
  156.  
  157.  
  158. 6. Minimum Requirements
  159.  
  160. • A 32MHz 68030, 68040, or PowerPC Macintosh.
  161. • System 7.1 or newer MacOS
  162. • Version 1.5 or newer of Apple’s PlainTalk Text-to-Speech software. I highly 
  163.   recommend using the voice “Fred” which is installed with Macintalk 3. All of the 
  164.   words and internal text is optimized to be most understandable with this voice.
  165. • Apple's Plaintalk software is available at http://www.speech.apple.com/ or it
  166.    can likely be found on your MacOS Install CD.
  167.  
  168.  
  169. 7. Limitations and Caveats
  170.  
  171. • Changing the printing Chooser device while Master Spell is running and then trying to
  172.    print will likely cause Master Spell to quit unexpectedly. This is not a feature.
  173.    (fixed in a future version due Summer 98)
  174. • Double-clicking Pupil files in the Finder opens Master Spell but does not load the 
  175.    Pupil file, as one would expect. (fixed in a future version due Summer 98)
  176. • Test files are limited to 28K in size.
  177. • Pupil History is limited to 28K in size (about 350 test entries, go beyond this and
  178.    I’m not really sure what happens).
  179.  
  180.  
  181.  
  182. 8. Master Spell is Shareware
  183.  
  184. This copy of Master Spell contains only the Basic Words test of over 300 words.
  185.  
  186. The complete package contains three other tests, Intermediate Words, Tricky Words and Difficult Words, for a total of at least 1,345 commonly misspelled words with tested pronunciations. I'm continuing to add more words after this 3.1.2 release. I'll keep registered users informed as I update the tests. The latest tests are available at:
  187.  
  188. http://homepage.interaccess.com/~jaylich/MasterSpell/
  189.  
  190. When you register, I will send you the password to unlock that StuffIt archive for the file at this site. If you received this software on a CD collection, it is possible that this password locked StuffIt file was included in the same folder with Master Spell and your extra tests are just waiting for a password.
  191.  
  192. Registration is $15 for individual users,
  193.                 $12 a copy for 3 or more copies,
  194.                 $10 for students,
  195.                 $150 for a Site license for one school,
  196.             and $500 for a World-Wide license for a school district.
  197.  
  198. Run the included “Register Master Spell” application to register.
  199.  
  200. A Site License costs $150 and covers all uses for one school. One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the software. A World-Wide License costs $500 and it covers all locations for your organization on the planet earth. This may be the most cost effective way to register for larger school districts.
  201.  
  202. Paying for Master Spell is fairly simple. Open the “Register Master Spell” program that accompanies Master Spell. Enter your name, your email address, and the number of single user licenses you desire for each program you wish to purchase (or Site or World-Wide licenses). Save or Copy or Print the data from the Register program and send the data and payment to Kagi. Kagi handles my payment processing.
  203.  
  204. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from “Register Master Spell” and paste into the body of an email message or you can Save the  data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number. 
  205.  
  206. Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 10 days and if you provide a correct internet email address you will receive an email acknowledgement. 
  207.  
  208. If you are paying with Cash or USD Check you should print the data using the Register application and send it to the address shown on the form, which is: 
  209.  
  210.               Kagi
  211.               1442-A Walnut Street #392-3X7
  212.               Berkeley, California 94709-1405
  213.               USA
  214.  
  215. It is also possible to register online with with a credit card on a secure page at Kagi at:
  216.  
  217.               http://order.kagi.com/?3X7
  218.  
  219. You can pay with a wide variety of cash from different countries but at present if you pay via check, it must be a check drawn in US Dollars. Kagi cannot accept checks in other currencies, the conversion rate for non-USD checks is around USD 15 per check and that is just not practical.
  220.  
  221. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with their payment.
  222.  
  223. Kagi can not invoice your company, you need to act on my behalf and generate the invoice and handle all the paperwork on your end.
  224.  
  225. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed. Payments send via postal mail take time to reach Kagi and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi when the form is processed.
  226.  
  227.  
  228.  
  229. 9. Miscellaneous
  230.  
  231. I purposely made one spelling error in this document. What is it? Shame on me if there is more than one spelling error.
  232.  
  233. If you are reading this and it is after the summer of 1998, there is likely a much improved version by now. As of writing this in March, I am porting my code to yet another IDE which will allow Master Spell many new abilities, cosmetic fixes and logistical fixes.
  234.  
  235.  
  236.  
  237. 10. Version History
  238.  
  239. Changes in version 3.1.3 (March 1998)
  240.  
  241. • Fixed problem where getting 100% still reported that you got some wrong.
  242.  
  243. Changes in version 3.1.2 (March 1998)
  244.  
  245. • Rearranged end test sounds and results so that they come after retrying
  246.    the words misspelled.
  247. • Fixed syntax errors and added words to the "Basic Words" test.
  248. • More background events friendly when loading a pupil.
  249.  
  250. Changes in version 3.1.1 (January 1998)
  251.  
  252. • Fixed bug where trouble words would be erased when "Load Pupil" or
  253.    "New Pupil" were selected and then canceled.
  254.  
  255. Changes in version 3.1 (January 1998)
  256.  
  257. • Graph display of test results
  258. • Printing of graph and scores
  259. • Tracking and integrating of trouble words
  260. • Retried words count for half credit
  261. • Various bug fixes and code clean-ups
  262. • Over 1,200 spelling words for registered users
  263.  
  264.  
  265. Changes in version 3.0 (December 1997)
  266.  
  267. • Rewritten from scratch as a stand-alone application
  268. • Added clarification for all Master Spell words
  269. • Added anti-redundancy, alternate spelling capacity, review of misspelled words, 
  270.   a presentation of all the words spelled correctly, incorrectly and correctly on retry, 
  271.   per word averaging, individual test history files, and audible and visible 
  272.   letter-by-letter correction
  273.  
  274.  
  275. Changes in version 2.0 (circa 1995) HyperCard
  276.  
  277. • Changed XCMD from Macintalk to Macintalk 3
  278. • Redid pronunciation for Macintalk 3
  279.  
  280.  
  281. Changes in version 1.1 (circa 1993) HyperCard
  282.  
  283. • Added compact stack on quit
  284. • Improved pronunciation and added clarification for several words